home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_4 / vark15 / utils a-o / crbexec.lha / crbexec / docs_1.txt < prev    next >
Text File  |  1996-06-25  |  9KB  |  243 lines
  1.  
  2. Manual for:
  3.  
  4.     ESCV
  5.     chainV
  6.     FileReqV
  7.     Iterate
  8.     OpalEQ
  9.     PadNum
  10.     CPY
  11.     latchV
  12.     StopLatch
  13.     UC
  14.     GetCedStat/SetCedStat 
  15.  
  16. **
  17. not yet written up for:
  18.     RunWB
  19.     DelInfo
  20.     bhead
  21.     btail
  22.     BlackOpal
  23.     ThumbV
  24.     IconM
  25.     SpawnM
  26.     TSearch
  27.     IFF2JPEG
  28.     UUprocess
  29. **
  30.  
  31. All programs and this document are copyright (c) 1993,1994 Charles Bloom.
  32.  
  33. These programs ARE NOT DISTRIBUTEABLE!  COPYING THESE PROGRAMS IS PIRACY 
  34. AND VIOLATORS WILL BE PROSECUTED!!!  These programs are given by gift of
  35. Charles Bloom only!  If you recieve these files by any other means contant
  36. Charles Bloom immediately!!  If I give you these, be grateful and don't
  37. spread them - that's my job, not yours!
  38.  
  39. The author can be reached at:
  40.  
  41. mail:    Charles Bloom
  42.     2501 Wickersham, apt. #911
  43.     Austin, TX 78741
  44.  
  45. net:    cbloom@mail.utexas.edu
  46.  
  47. All of these programs are compiled for 68030 and 68881 machines or better 
  48. only.  All are optimized for use on these processors.
  49. ----------------------------------------------------------------------
  50. ESCV:
  51.  
  52.     This is a picture viewer for OpalVision.
  53. It only quits when ESC is pressed.
  54.  
  55.     This was written so that two monitors could be used on the same Amiga
  56. in the following fashion: one displaying an OpalVision picture (with this
  57. program), the other running normal Amiga programs.
  58.  
  59. ----------------------------------------------------------------------
  60. chainV:
  61.  
  62.     This program will display multiple files continuously.  This means
  63. that only one screen will be used, and the first picture stays up while the
  64. second is loading, etc. for minimum black-screen between frames.  Useful
  65. for making tapes or just viewing (easier than OpalPresents)
  66.  
  67. ----------------------------------------------------------------------
  68. FileReqV:
  69.     
  70.     Uses the OpalVision file requester to display pictures (thumbnails,
  71. etc.)  Just try it, its all point and click.
  72.  
  73. ----------------------------------------------------------------------
  74. Iterate:
  75.  
  76.     This is a shell program, primarily written for script files.  It
  77. will perform an operation on file names with incrementing numbers in them,
  78. such as frames of an animation (pic.1,pic.2,pic.3,etc.) for all frames in
  79. the sequence.  The syntax is:
  80.  
  81.     Iterate <FILENAME> <COMMAND> <ARGS>
  82.  
  83.     <ARGS> should contain <FILENAME> in the apropriate place.
  84.     The number to be iterated should be represented as the '#' character.
  85.  
  86. For example, to view a series of pictures:
  87.  
  88.     Iterate pic.# ESCV pic.#
  89.  
  90.     This will perform "ESCV pic.#" until "pic.#" no longer exists.
  91.  
  92. A wierd example:
  93.  
  94.     Iterate pic.# delete pic.#.info
  95.  
  96.     This will delete all the .info files for a set of pictures, until
  97. "pic.#" no longer exists.  Note that the test file name and the actually-used
  98. file name are different.  This means that if pic.9.info exists, but pic.9
  99. does not, pic.9.info will not be deleted.  This would make more sence the other
  100. way around, but that ain't the way it works :^)
  101.  
  102. ----------------------------------------------------------------------
  103. OpalEQ:
  104.  
  105.     Yet another OpalVision program.  This one will plot equations for
  106. R,G,and B with respect to x and y as pictures, and let you save the result
  107. as an IFF24.  Run it from WorkBench or CLI.
  108.  
  109.     The prompts for Red, Green, and Blue want a function F(x,y).  The 
  110. three colors have independant equations.
  111.  
  112.     The syntax of the equations is as follows:
  113.  
  114. F(x,y) = PHRASE +- PHRASE +- PHRASE ....
  115. PHRASE = TERM <op> TERM <op> TERM ....
  116.     <op> can be: *,/,or ^
  117. TERM = (PHRASE +- PHRASE +- PHRASE ....) 
  118. or TERM = numeric
  119.     numeric can be just a number (like 8, or 900, or 9.2134).  There are 
  120.     two special numbers: e and pi (spelled like that, lower case).
  121. or TERM = <function> TERM
  122. <function> can be: sin, cos, tan, ln, log, cosh, sinh
  123. note that since <function> is performed on TERM, these functions are performed
  124. on the next numeric or the set of phrases in paranthesis.  
  125.     TERMs may be X and Y
  126.  
  127. Examples:
  128.  
  129.     4*3*2 = 24        1 PHRASE , 3 TERMs, 2<op>s
  130.     4*(3*2) = 24        1 PHRASE , (3*2) is a TERM: 2 TERMs
  131.     7*(1+2) = 21        1 PHRASE
  132.     1+7*2 = 15        2 PHRASEs
  133.     4*sinpi-pi = -pi    2 PHRASEs, 3 TERMs
  134.     sinpi*cos0 = -1        1 PHRASE , 2 TERMs
  135.     sin(pi*cos0) = 0    1 PHRASE , 1 TERM
  136.         etc...
  137.  
  138. You can make some pretty patterns using trig & log functions.
  139.  
  140. ----------------------------------------------------------------------
  141. PadNum:
  142.  
  143.     This program expands numbers like 4 to 0004 (pads numbers with leading
  144. zeros).  This is useful for naming things for use in animations.  To run from
  145. the WorkBench, click once on PadNum, select all the files to pad, then double
  146. click the last one.  PadNum will also pad .info files.
  147.  
  148.     Syntax:
  149.  
  150.     PadNum <#> <file1> <file2> <file3> ....
  151.  
  152.     <#> is the number of digits to pad to.  For example: <#>=4 would pad
  153.     '5' to '0005'.  <#>=2 would pad '5' to '05'.  
  154.     YOU MUST NOT HAVE MORE DIGITS THAN <#>!  For example: <#>=2 would be
  155.     very confused by '103'!!
  156.  
  157.     <#>=0 will depad numbers.  For example, '00006' would become '6',and
  158.     so on.  
  159.  
  160.     To decrease padding on a number, you must first depad, then repad.
  161.  
  162. ----------------------------------------------------------------------
  163. CPY:
  164.  
  165.     This is another cheesy hack.  The purpose of this program is to mimic
  166. the MS-DOS copy in which if you type "copy <filename>" with no second paramater,
  167. the <filename> is copied into the current working directory.
  168.  
  169.     For example:
  170.  
  171.     CPY c:memacs
  172.  
  173.     would copy memacs into the current directory.
  174.  
  175. ----------------------------------------------------------------------
  176. LatchV:
  177.  
  178.     This is another picture viewer.  This viewer copies the image into the
  179. OpalVision frame buffer, sets the 'latch' bit (thence the name) and then 
  180. completely quits.  The image is not stored anywhere in Amiga memory, only on the
  181. OpalVision.  This means that: THIS VIEWER USES 0k of RAM!!!  Note that there is
  182. no control line at the top of the screen the way there usually is.  This 
  183. picture will remain displayed even if the computer reboots (as long OpalVision
  184. is receiving power to its RAM).
  185.  
  186.     The picture will only go away when another OpalVision screen wants it.
  187. ( calling OpenScreen24 ).
  188.  
  189.     This program is only useful when running two monitors simultaneously.
  190.  
  191. ----------------------------------------------------------------------
  192. StopLatch:
  193.  
  194.     This is a cheesy hack.  It opens and closes a screen to clear anything
  195. which is currently latched in.  It has the effect of clearing and closing a
  196. picture loaded by LatchV.
  197.  
  198.     Note that BackDrop24 and OpalHotKey use the 'latch' method also, and this
  199. program will clear them as well.  They will not be expecting to be cleared by
  200. this program, but should not have any problem with it.
  201.  
  202. ----------------------------------------------------------------------
  203. UC:
  204.  
  205.     UltimateClock.  This is a tiny, powerful clock.  It is pure and can be
  206. made resident.  It is only 5k in size and minimizes memory while still
  207. being very processor-friendly while running.  Parameters may be passed on
  208. the command line from CLI or as Tool Types from workbench.  Parameters are:
  209.  
  210.     NOTIME        doesn't display the time (default is to display the time)
  211.     AMPM            displays 12-hour time w/ AM & PM (default is 24 hour)
  212.     DATE            displays the date
  213.     FASTMEM        displays "Fast: #" for amount of fastmem available
  214.     CHIPMEM     displays "Chip: #" for amount of chipmem available
  215.     SCREEN=<name> loads UC on a PublicScreen named <name>; note that <name> 
  216.         must be exactly correct (including capitalization & punctuation)
  217.     TOPY=<coord>  sets the top y coordinate for the clock window on startup
  218.  
  219. ----------------------------------------------------------------------
  220. GetCedStat/SetCedStat:
  221.  
  222.     These are two programs designed to work together with Ced to make it more
  223. friendly.  Both are about 3k in size and are pure, and can (and should) be
  224. made resident.  I use a commodity-hotkey program to call them from
  225. lcommand-g for getcedstat and lcommand-s for setcedstat.  Their functionality
  226. as is follows:
  227.  
  228.     load files into Ced, do whatever
  229.     to quit, run GetCedStat.  This will log the name of all the open files,
  230.         and your position in those files
  231.     to restart, run SetCedStat.  This will restore the previous files and jump
  232.         to where you were editing them
  233.  
  234.     These programs require the drawer ENVARC:CedStat to be created before
  235. running them.  They will save the file envarc:cedstat/cedstat.
  236. SetCedStat will run the Rexx program envarc:cedstat/init.rexx   Note that
  237. this rexx program must address Ced itself (see my example) because it is
  238. not given the host.  I also use a file called envarc:cedstat/ceddefs for
  239. default settings, which I load in init.rexx
  240.  
  241. TODO: make getcedstat call closedown.rexx and save an icon based on the
  242. file extension
  243.